Graphical Java Lesson 1-11: Staring into the Abyss 


In the previous lesson, we added Mario-Goomba combat to our game. Characters could now kill each 
other, and be killed, themselves. This feature allowed us to call our program a game, since the lives of 
Mario and the Goombas were now at stake. 


However, in Super Mario Bros., getting touched by an enemy is not the only way in which Mario can 
die. Mario can also die, by falling into an abyss, or by touching a harmful substance, like lava. In this 
lesson, we'll add an abyss and some lava to our world. If a character (Mario or a Goomba) touches 
either one of these "death zones", he will die, immediately. 


Since we'll be adding a new type of object to our world, we'll need to make a new class: DeathZone. 
Since falling into an abyss and touching lava will each do the same thing to a character, we can 
generalize these things, to come up with the general idea of a "death zone". After you have created the 
DeathZone class, go to your DeathZone. java source file. 


We'll keep our death zones simple: rectangular and of one solid color, just like platforms. Therefore, 
add the following member variables to your DeathZone class: 


private Rectangle my rect; 
private Color my color; 


Then, import the Rectangle and Color classes, with the following import statements: 


import java.awt 
import java.awt 


.Rectangle; 
wCoLor; 


ct ct 


If you have a good memory, you'll notice that the DeathZone and Plat form classes each have the 
same member variables. Hmmm .... Give your DeathZone class the following constructor: 


public DeathZone (Rectangle r, Color c) 
{ 


my rect = r; 
my color = ¢7 


} 


Again, you could have copied it from your Platform class. Drawing a DeathZone will be like 
drawing a Platform, so copy the following draw method from your Platform class to your 
DeathZone class: 


public void draw(Graphics g) 
{ 

q.selColor (my color); 

g.f111Rect (my rect.x, my rect.y, my_rect.width, my rect.height); 
} 


Remember to import the Graphics class, with the following import statement: 
import java.awt.Graphics; 
Finally, your DeathZone class will need the following accessor method: 


public Rectangle myRect () 
{ 


return my rect; 


} 


Your DeathZone class does not contain a single line of code that you could not have lifted from your 
Platform class! The two classes contain such similar code, because we'll essentially treat a 
DeathZone object like "a platform that kills you, if you touch it in any way". 


Now that we have our DeathZone class, let's add some death zones to our world. Go to your 
WalkingMario.4java source file. We'll make our world able to contain any number of death zones, 
so add the following declaration to your list of global variables: 


public static ArrayList<DeathZone> death zones; 
Next, in your main method, right after the lines that create our world's platforms, like ... 


plats.add(new Platform(new Rectangle (WINDOW WIDTH, 
WINDOW _HEIGHT - 50, 10, 50), Color.BLUE)); 


... let's initialize ourArrayList, death zones: 
death zones = new ArrayList<>(); 


After the above line of code, let's create an abyss below the black platform: 


death zones.add(new DeathZone (new Rectangle (-1000000, WINDOW HEIGHT, 
2000000, 1000000), Color.RED)); 


The above death zone will span a HUGE area below the black platform. Therefore, if any character 
falls below the black platform, he will end up touching this death zone, and then dying. It will be red, 
although we won't be able to see it, because it will be located just off the bottom edge of the screen. 
Let's also create a red patch of lava above the magenta platform: 


death _zones.add(new DeathZone (new Rectangle(400, 200, 20, 20), 
Color.RED) ); 


We'll be able to see the lava, because it will be located within the boundaries of the window. However, 
we won't be able to see ANY of these death zones until we draw them, so let's do that next. Go to your 
ContentPane. java source file. 


We'll draw our death zones behind everything else, so we'll draw them first. How does drawing 
something first put it behind everything else? In the paintComponent method of your 
ContentPane class, before ... 


for (int i = 0; i < WalkingMario.plats.size(); i= i+ 1) 
WalkingMario.plats.get(i).draw(g); 


... insert the following for loop: 


for (int i = 0; i < WalkingMario.death zones.size(); i= i+ 1) 


WalkingMario.death_zones.get (i) .draw(g) ; 


Run your program. Mario can still kill Goombas, and be killed by them. However, if Mario or a 
Goomba touches the lava, or falls into the abyss, he won't die. In the collision-detection code of our 
Mario and Goomba classes, we need to add checks for whether Mario or a Goomba has become 
"glitched into" a death zone. Characters will perform their sub-moves, as usual. After a character 
performs a sub-move: 


¢ Ifhe is "glitched into" a platform: 
© Undo that sub-move. 
© Don't perform any more sub-moves, because his path was blocked by a platform. 
* Else, if he is "glitched into" a death zone: 
© Undo that sub-move. 
© Kull him, immediately. 
© Don't perform any more sub-moves, because his path was blocked by a death zone. Since he 
is now dead, he can't move any more. 


First, we'll make a death zone kill Mario, if he touches it, so go to your Mario. java source file. 
Since we have implemented collision-detection in our actuallyMove method, our most important 
changes will be made to that method. However, we'll first need a method that will check if Mario is 
"glitched into" any death zones. Add the following method to your Mario class: 


public boolean isInADeathZone () 
{ 
for (anh i= O07 1. < WalkingMariov.death zones.size(); 1.= 20+ 1) 
{ 
if (my rect.intersects (WalkingMario.death zones .get (i) .myRect ())) 
return true; 


} 


return false; 


} 


If you have a sharp memory, you'll notice that is InADeathZone is similar to isTnAPlatform. 
We'll be using our is TnADeathZone method in a similar way, because, as I have said before, a 
DeathZone object is like a platform that kills you, if you touch it in any way. 


Now, go to your actuallyMove method. After Mario performs one of his sub-moves, the program 
will execute the if statement that begins with if (isTnAPlatform() ). Between the if block and 
the else block of that if statement, insert the following else if block: 


else if (isInADeathZone() ) 

{ 
undoSubMove (sign xv, sign _yv, mxv_larger, made _small_ step); 
die(); 
break; 


} 


We insert the above else if block between the if block (which checks if Mario is "glitched into" a 
platform) and the e1se block (which performs any other collision-detection involving Mario), because 
Mario must not first be blocked by a platform, or blocked and killed by a death zone, for him to be able 
to fight enemies, get power-ups, or do anything else, on this sub-move. 


Run your program. Now, if Mario touches the lava, or falls into the abyss, he'll die. Let's make our 
death zones kill Goombas, too. Go to your Goomba . java source file. The process of checking 
whether a Goomba has collided with a death zone will be similar to the process for Mario. 


First, copy the is TnADeathZone method from your Mario class to your Goomba class. One of the 
steps of our collision-detection algorithm involves undoing one of the Goomba's sub-moves. Since 
there will be two places in our actual 1 yMove method that perform this action, let's factor out the 
bulky code that undoes a sub-move. To factor out a duplicated piece of code is to place it in a method, 
and then replace that code, in its original locations, with calls to that method. The process of factoring 
out repetitive code is similar to the process of factoring out an x, from the mathematical expression, 

5x + 3x, to yield the more compact expression, (5 + 3)x. 


To factor out the code that undoes a sub-move, copy the undoSubMove method from your Mario 
class to your Goomba class. Then, in your actual1lyMove method, in the if block with the 
condition, if (isInAPlatform() ), replace... 


if (mxv_larger) 
{ 


my rect.x = my rect.x -— (sign xv * 1); 


if (made_small_ step) 
my rect..y = my rect.y = (sign. yr * 13 
} 


else 


{ 


ny rect. y = my. rect.y = (eign yre* 1); 
if (made_small_ step) 


my Keck.x = my rect.x — (sign xv * 1); 


} 
... with the following call to undoSubMove: 
undoSubMove (sign xv, sign _yv, mxv_larger, made small step); 


Finally, we'll need to check whether the Goomba has become "glitched into" a death zone, and take 
appropriate action, if this is the case. Go to your actuallyMove method. Right after ... 


if (1sInAPlatform() ) 
{ 


undoSubMove (sign xv, sign _yv, mxv_larger, made _small_ step); 


if (isBlockedByALeftWall () ) 
moving right = true; 

else if (isBlockedByARightWall ()) 
moving right = false; 


break; 


} 
... add the following else if block: 


else if (isInADeathZone()) 

{ 
undoSubMove (sign xv, sign _yv, mxv_larger, made_small_ step); 
die(); 
break; 


We keep duplicating our code; if only there was a way to factor out some more of it .... Run your 
program. Everything should work as it did before, but how can we check that Goombas get killed, 
when they touch death zones? We could: 


¢ Add new death zones in places that our existing Goombas will eventually touch. 
¢ Add new Goombas, such that they will eventually fall into the lava we already have. 


Make sure Goombas get killed, when they touch death zones. Feel free to play around with this 
code, but before you change anything, you might want to save a backup copy first, in case you mess 
something up, and don't know how to fix it. 


